Polo — a shared reverb for the whole session
=============================================

Two plugins, one acoustic space:

  Polo Send   Drop one on each source track. It taps the track's audio into a
              shared bridge and passes through unchanged. Its one creative
              control is DISTANCE FROM LISTENER.

  Polo Sum    The reverb itself (plate / hall), one instance on a return track.
              It reads every Send, derives each source's pre-delay, level and
              air-absorption damping from that source's distance, and feeds
              them all into ONE reverb. Global controls (type, decay, damping,
              width, max pre-delay, low cut, wet level) live here.

Because every track shares the same reverb but arrives at its own distance,
the mix sits in one believable space instead of N parallel reverbs.

Build (all platforms):

  git submodule update --init --recursive
  cmake -B build
  cmake --build build --config Release

Linux installation:

  Linux ships VST3 and CLAP only (no AU, no AAX). Extract the .tar.gz and run:

    ./install.sh              install for the current user (~/.vst3, ~/.clap)
    ./install.sh --system     install system-wide (/usr/lib/vst3, /usr/lib/clap), needs sudo
    ./install.sh --uninstall  remove the per-user install (add --system for the system-wide one)

  Or copy the bundles manually:

    Polo Sum.vst3   ->  ~/.vst3/   (or /usr/lib/vst3 for --system)
    Polo Sum.clap   ->  ~/.clap/   (or /usr/lib/clap for --system)
    Polo Send.vst3  ->  ~/.vst3/
    Polo Send.clap  ->  ~/.clap/

  After installing, restart your DAW and rescan for plugins.

  License file location on Linux: ~/.config/Polo/license.json

Read HOUSEKEEPING.md before working in this repo.
